| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The FeaturesActive property sets or retrieves the features that are currently active.
Syntax
objMSVidCtl.FeaturesActive As MSVidFeatures
Parameters
This property takes no parameters.
Error Codes
If the property fails, an error is raised and Err.Number is set to a value other than zero.
Return Values
Returns an MSVidFeatures collection.
Remarks
Features represent additional capabilities beyond basic tuning and rendering, such as closed captioning or IP data services. When the Video Control builds the filter graph, it uses the active features collection to configure the graph.
If no features are active, the value of this property might be Nothing. Otherwise, it returns an MSVidFeatures collection; use this collection to enumerate the features. The Conditional Access feature is always active and cannot be removed by an application.
For a default graph, it is not necessary to specify the active features. To activate a feature, create a new MSVidFeatures collection object. Enumerate the available features using the Video Control's MSVidCtl.FeaturesAvailable property. If the IMSVidDevice.ClassID property matches the class identifier (CLSID) of the feature you wish to activate, add that feature to your MSVidFeatures collection. Finally, set the MSVidCtl.FeaturesActive property equal to the new MSVidFeatures collection.
If the MSVidCtl.State property is not STATE_UNBUILT, call the MSVidCtl.Decompose to tear down the filter graph before setting this property.
This property is read/write.
See Also